home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / winsock / twnsck12.zip / README.TXT < prev    next >
Text File  |  1994-12-04  |  8KB  |  229 lines
  1.                 TwinSock 1.2
  2.                 ============
  3.                 Troy's Windows Sockets
  4.                Copyright 1994 Troy Rollo
  5.  
  6.         Yes, I'm back again. It seems it always takes me
  7.         two or three goes to hand projects over. Unless
  8.         somebody volunteers to take this over now, and
  9.         has the time to do it, this will be the last
  10.         version until at least late January.
  11.  
  12.                 - Troy
  13.  
  14. What is TwinSock?
  15. -----------------
  16.  
  17. TwinSock is a free implementation of proxy sockets for Windows.
  18.  
  19. Other Windows Sockets drivers use a network card, or a well known Internet
  20. over serial lines protocol, such as SLIP, C-SLIP or PPP. These drivers may
  21. access the network card or communications card directly, or via a VxD or DOS
  22. based TCP/IP stack. their uses are limited to cases where either the machine
  23. is directly connected to a network, or the host at the other end of the phone
  24. line supports the same serial line internet protocol.
  25.  
  26. The other shortcoming of these drivers is that they require an official IP
  27. address to operate, and frequently you will not be able to connect very far
  28. beyond the host you connect directly to.
  29.  
  30. TwinSock, on the other hand, makes use of the IP address of the host to
  31. provide socket services to the client. When an application running under
  32. Windows requests socket services of TwinSock, TwinSock will transparently
  33. pass these requests on to the TwinSock Host program running on the remote
  34. machine for processing. The result is that you have all the same networking
  35. capabilities as you would if your Windows machine were physically connected
  36. to the network in place of the host machine.
  37.  
  38. For more information on what TwinSock can do for you, read on, or refer to
  39. one of the following newsgroups, where TwinSock is discussed:
  40.  
  41.     alt.dcomp.slip-emulators
  42.     comp.os.ms-windows.networking.tcp-ip
  43.     comp.os.ms-windows.apps.comm
  44.  
  45. Licensing
  46. ---------
  47.  
  48. TwinSock is free software; you can redistribute it and/or modify
  49. it under the terms of the GNU General Public License as published by
  50. the Free Software Foundation; either version 2 of the License, or
  51. (at your option) any later version.
  52.  
  53. This program is distributed in the hope that it will be useful,
  54. but WITHOUT ANY WARRANTY; without even the implied warranty of
  55. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  56. GNU General Public License for more details.
  57.  
  58. You should have received a copy of the GNU General Public License
  59. along with this program; if not, write to the Free Software
  60. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  61.  
  62. Installing
  63. ----------
  64.  
  65.     1. Copy WINSOCK.DLL and TWINSOCK.EXE to your Windows directory.
  66.  
  67.     2. Copy the following files to an empty directory on your UNIX
  68.        host.
  69.  
  70.         build.sh
  71.         commands.c
  72.         mem.c
  73.         packet.c
  74.         packet.h
  75.         term.c
  76.         tshost.c
  77.         twinsock.h
  78.         tx.h
  79.         wserror.h
  80.  
  81.     3. Type "sh build.sh" to build the server. build.sh will attempt
  82.        to figure out what options it needs to use to compile on most
  83.        32 bit systems. 64 bit systems may need significant porting
  84.        work.
  85.  
  86.        If it doesn't compile first off, try to modify it until it does
  87.        if you know enough about programming. The files you will probably
  88.        need to touch are (in decreasing order of probability):
  89.  
  90.         term.c
  91.         tshost.c
  92.         commands.c
  93.  
  94.        You should avoid touching packet.c if possible.
  95.  
  96.     4. Start the TwinSock client. You may get a message indicating
  97.        that COM1 could not be opened, followed by a box asking you
  98.        to configure the communications port. If you do not, select
  99.        Setup...Communications.
  100.  
  101.        Select your communications parameters, and click "OK".
  102.  
  103.     5. You will now be in TwinSock terminal mode. Type "Enter" a few
  104.        times and you should see your UNIX prompt. Start "tshost", the
  105.        TwinSock Host program. TwinSock should iconise and change its
  106.        title to "Twinsock - Connected". At this point you can start
  107.        your Windows sockets applications.
  108.  
  109. Shutting down
  110. -------------
  111.  
  112.     1. Double click on the TwinSock icon.
  113.  
  114.     2. Select Setup...Disconnect from the menu.
  115.  
  116.     3. If TwinSock host does not shut down, wait 5 seconds, then
  117.        type ^X five times.
  118.  
  119. Enhancements and Bug Reports
  120. ----------------------------
  121.  
  122.     Enhancements and bug reports should be directed to:
  123.  
  124.         twinsock@cbme.unsw.EDU.AU
  125.  
  126. TODO & BUGS
  127. -----------
  128.  
  129.     The protocol used over the serial connection converts everything
  130.     to base 64 using the characters A-Z, a-z, '.' and '/' in order to
  131.     get past the most obstinate terminal servers. This is probably
  132.     overkill in almost all cases, and there should be an option to
  133.     fix this.
  134.  
  135.     Out Of Band data should be handled properly.
  136.  
  137.     The internals don't clean up properly if an application exits
  138.     without cleaning up itself.
  139.  
  140.     TwinSock Host should be ported to more hosts, including non
  141.     UNIX hosts.
  142.  
  143.     There should be a facility to script logins so all you have to
  144.     do is hit the TwinSock icon in the Program Manager.
  145.  
  146.     There's appears to be an undefined dynalink in there somewhere.
  147.  
  148. History
  149. -------
  150.  
  151.     05-Nov-1994    Project initiated
  152.     14-Nov-1994    Version 1.0 released
  153.     20-Nov-1994    Version 1.1 released
  154.     04-Dec-1994    Version 1.2 released
  155.  
  156. Changes in version 1.1
  157. ----------------------
  158.     This version includes a number of bug fixes and usability
  159.     enhancements.
  160.  
  161.     Bugs fixed from 1.0:
  162.         Most of the WSAGetXbyY functions didn't work at all.
  163.  
  164.         Telnet applications won't drop typed characters 
  165.         anymore.
  166.  
  167.     New features:
  168.         The host end now tries to figure out what it needs to
  169.         do to compile on your system. This ability is probably
  170.         not complete yet, but should work for most 32 bit
  171.         UNIX platforms.
  172.  
  173.         Now has a terminal interface. This means you can log
  174.         in to your host and start TwinSock Host without needing
  175.         a separate terminal program.
  176.  
  177.         Data received from the network is now "streamed" this
  178.         means that if you are in the middle of a long file
  179.         transfer, you can still get in to do other things while
  180.         the transfer is still going. Also, when you abort a
  181.         connection, the unwanted data is discarded at the host
  182.         end.
  183.  
  184.         TwinSock Host now sends a character sequence to TwinSock,
  185.         which then automatically initiates the connection
  186.         automatically.
  187.  
  188. Changes in version 1.2
  189. ----------------------
  190.  
  191.     Bugs fixed from 1.1:
  192.         A number of bugs to do with byte swapping have been
  193.         fixed. Thanks go to Jim Reuter of DEC for his detective
  194.         work on this.
  195.  
  196.         The setsockopt calls have been changed to have the
  197.         last argument not passed by address. This was my
  198.         error, not a SysV/POSIX/BSD difference as many have
  199.         speculated.
  200.  
  201.     Behaviour changes:
  202.         The default line settings have changed. TwinSock now
  203.         uses DSR for handshaking. This can be changed back to
  204.         the old behaviour by adding the line "OutxDsrFlow=0"
  205.         to the config section of TWINSOCK.INI
  206.  
  207.         build.sh should now detect "-lnsl" and shouldn't
  208.         incorrectly include mem.o in the compilation when
  209.         using gcc (which has built-in prototypes).
  210.  
  211.     New features:
  212.         The one packet positive Ack protocol has been changed to
  213.         a four packet windowed protocol. This improves speed by
  214.         a factor of four (no, making it an 8 packet windowed
  215.         protocol will not give an 8 times improvement).
  216.  
  217.         You can now dial the modem from the menu, if you're averse
  218.         to entering dial commands yourself. The dialing code
  219.         will remember your most recently dialled number, so
  220.         for most people this means dialing will be a simple
  221.         matter of selecting Setup...Dial...OK (after the first
  222.         time).
  223.  
  224.         There is now a menu option  to send a break signal
  225.         (Setup...Send Break Signal). The break signal will
  226.         last for 1.5 seconds.
  227.  
  228.  
  229.